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SOME recent developments in the retail field... NCE/Compumart decided on 
Dec? 1 to drop the Bally line. They will fill all back orders and repair 
units. JS&A no longer shows the Bally in their catalog, and they expect to 
have their backlog substantially reduced by the end of the year, including 
repair. There is an article in a recent Business Week that indicates that 
Bally may drop the production of the Arcade^,but the factory denied this 
and a retraction is in progress. 

THREE TONE MUSIC has been accomplished. I heard a tune the other day, and 
it is not bad. At the moment, the sounds are created by direct access to 
the chip via machine language, but we are getting indications of how to 
do it at the BASIC language level. Seems like &(n)=p yields some results 
when n varies from 16 to 23 

ALONG the musical line, if the tone generator can be replaced by a unit 
like the one described in the November 73, we'll get realism. The article 
discusses a unit that varies the harmonic content and envelope of a note, 
therebye making it representative of an actual instrument. 

A new dealer in my neighborhood is the Emporium chain, and also Home Cinema 
of Santa Clara and San Rafael. The manager of the Santa Clara store invites 
Arcadians to identify themselves for special consideration. They manufac* 
ture a rugged interface switch -the one that goes to the back of the TV- 
for use with the Bally. 

FOUR COLOR SCREEN is now available, as follows: substitute the desired 
color number for the values n and p. 

First off, split the screen with a vertical line by using &(9) = s 

where s is 84 if you want the split in the middle 

Use BC and FC to give the left side colors as in the book 

Use &(2) = n &(3) = n to give the right side foreground 

Use &(0) = p &(1) = p to give the right side background 

$ gives access to the internal calculator. Not much known about that yet 

THE ADD-ON now seems to be scheduled for full marketing for next year's 
Christmas season. The last inputs will be made after the Januaiy show, 
and production start in April. 


APPARENTLY some of the handwritten material in the last issue did not 
reproduce well, so it has been typed and included here: 


TRY THIS: 

10 PRINT &(23) 

20 GOTO 10 

and run the program. 

In turn press each key in the left hand 
row and see the 
appropriate numbers appear 


&(M)=N appears to set output 
decimal port $1 to the value of N 
and 

N=&(M) appears to read the 
value of the M input port into the 
variable N. 


Use this program for checking out your 
controller joystick operation to see that it 
fimctions in all positions 


10 &(t6) = 5x (1) 
20 PRINT &(16) 

30 GOTO 10 


HERE are some more secrets from the depths of the Tiny BASIC . I am also 
reprinting a copy of a technical paper that has a lot of background infor¬ 
mation about the entire system. Sorry about the legibility in places. 

A couple of comments on string constants. The @ must be used with 
(). Your example on pg.U did not show this and may cause confusion for 
some. The characters p roduced wit h TV=@() duplicate for the most part, 
the ASCII decimal code Hy unit starts out with 900 strings 

available, but decreases one string for every two bytes of program stored. 
(Therefor 900 strings = 1800 bytes) 

Other commands 


10 FOR A = -10 TO 10 
20 B = ABS(A) 

30 PRINT A,B 
kO NEXT A 

£0 IF KP = "1 " GOTO 70 
60 STOP 
70. 


TBASIC has two additional commands not 
indicated in their manual. ABS() produces the 
absolute valueji.e., it changes a negative 
number to a positive. A STOP statement does 
just that, and can be placed anywhere in the 
program. I use the KP statement to place a 
temp. halt in the program. In this case, 
depressing a *1 * causes a jump to statement 
70. Any other character and the program stops. 


I've had some interesting results with the GALL () command most 
not worthy of repeating. Similar in some respects to <St(l3). One 
of the most interesting was the display of the large GAME OVER printout 
that occurs in the games portion. 

You might have your experts play with the $. Try the following 
and other variations. 


10 FOR A = 1 10 256 
20 $ = A,B,C 
30 PRINT A,B,C 
hO NEXT A 


10 FOR A = 1 TO 256 
20 $ = *(A),B,C 
30 PRINT A,B,C 
JUO NEXT A 


RECEIVED a question about the hand controller connector. It is an RS-232 
connector, with nine contacts. One dealer is JADE Computer Products, of 
4901 W. Rosencrans, Hawthorne,CA 9°250. Part number DE-9S, at $2.15* In 
addition they have a cover at 1.25, to finish it off. 
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Abstract .... ‘riu 

Heme computer users are Just now discovering 
computer graphics. Modest extensions to BASIC al¬ 
low plotting but not much more. The Bally Home 
Library Computer, however, has hardware to aid im¬ 
plementation of video games. Custom integrated 
circuits working on a 160X102 pixel (2 bits per 
pixel) color television screen allow certain forms 
®f animation in real time. To give this power to 
the user, BASIC Zgrsss has been designed and im¬ 
plemented. It is an extension of BASIC that al¬ 
lows parallel processes, picture objects that 
move, scale and group together as well as several 
drawing modes. There are also software controls 
of a three-v&loe music synthesiser, interactive 
input devices, a film camera and an IEEE bus in¬ 
terface. He will concentrate mainly on the 
language design for making it all easy to learn 
and use. , 
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‘Introduction and General Motivation 


Zgraas can be called an immodest extension of 
BASIC (Ted Nelson refers to It as "Super BASIC" 
(1J). It is an extension in that graphics support 
and user instruction facilities have been added to 
the capability of running BASIC programs oopled 
out of a hobbyist computer magazine. It is immod¬ 
est in that great liberties have been taken to 
weed out some of BASIC's undesirable programming 
conventions. Zgraas is actually a video game pro¬ 
gramming language designed specifically to en¬ 
courage creation of beautiful animations in short 
order. It is also designed to teach many of the 
important concepts of interactive systems and 2-D 
computer graphics. . r - 

The hardware used is the Bally Home Library 
Computer built around the Bally Arcade unit. It 
is a Z-80 based machine with special integrated 
circuits which help the 'processor manage the 
160x102 2-bit-per-pixel color output connected to 
any standard color tv set. The alphanumerics gen¬ 
erated by program output and keyboard input are 
video mixed over the color graphics so text is not 
constrained to the 160x102 format. The two bits in 
each pixel indicate one of four bytes from which 
an index into a 256-element color map is taken. 
Thus, four of 256 colors can be on the screen at 
once. The hardware also includes some tricks 
which have been found useful in professional video 



-aroade units. Its projected cost,* without oolor 
tv, is about #750.00, including the arcade unit. 

- : ■ Zgrass Itself takes up 16k bytes of ROM 

storage .and has 16k bytes of RAM for user storage 
and system use. An additional 16k ROM (referred 
'to as the 'extension* below) plugs into the aide 
-and provides room for a compiler and other 
.features. . ... Audio cassette storage and modem link¬ 
age to other computers is provided. Software for 
'driving optional intelligent floppy disk drives la 
;also built-in.. Further hardware in this unit -'In¬ 
cludes four hand controls, a 2*-key pocket calcu¬ 
lator keyboard, a three-voice sound generator and 
an IEEE Bus interface. Zgrass is the operating 
system for this computer as well. ‘ r\ 

Zgrass design concepts are rather different 
from those apparently underlying the current batch 
of home computer systems. Hone systems are now 
trying very bard to be cheap minicomputers for ex¬ 
pert users. These users when at home can be 
likened to the bam radio operators of the nineteen 
fifties, able to ohange diodes, violently shake 
-intermittent boards and, in general, understand 
the innards. .These persons can also get gratifi¬ 
cation from ‘ fighting with manuals and the trials 
of the latest software release. Just as we profes¬ 
sionals do for a living. - '511 * 

■ • Zgrass, however ' is designed for the' two- 
,• bour-a-week user. This type of person is 

guaranteed to continually forget the syntax and 
semantics of whatever software exists. Zgrass is 
designed (certainly at the oost of computer time 
and memory use) so the user does not have to rely 
on a manual to .decipher everything. In short, 
this system is trying to be the Model T of the 
home computer industry, with all that implies. He 
shall see. . .. - *--■ 

Above all, Zgrass is designed to be as at¬ 
tractive and as fun as pinball but considerably 
more intriguing and useful. 


General Zgrass Concepts 


"Right away" is the foremost design concept 
of Zgrass. Positive experiences in the first two 
hours of play are essential. When it is not part 
of your Job or intended career, you must be able 
to do interesting, beautiful things right away, 
without reading a five-pound manual. 

- BASIC is now the home computer language. 

•BASIC was designed as a teaching language and 
shines in its simplicity and easy matrix opera¬ 
tions. It is, however, a poor language for the 
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manipulation of anything but numbers. It has no 
features that sake writing large pr-ogams (over 200 
statements) easy. Its subroutine capability Is 
archaic. But, It la obviously a success In what 
the designers Intended, otherwise It could not 
presently be the universal home computer language. 

In particular, though, BASIC Is s poor 
language for animation. To be sure, plotter art 
and decaying sine curves are well suited to BASIC. 
But our almost eight years of experience with the 
GRASS language[2] and Dan Sandin's color video Im¬ 
age Processor[3] as well as being directly or In¬ 
directly Involved with roughly half of the most 
popular arcade video games, has given us Insight 
into the potential of a color tv set, and you Just 
cannot do a tv set Justice In BASIC. 

The next several pages will give details on 
syntax of Zgrass, but first we will further con¬ 
sider the "right away* criterion. Anyone who al¬ 
ready knows BASIC should be able to write Zgrass 
programs immediately. For those persons in Ameri¬ 
ca who do not religiously read "BYTE" or "Creative 
Computing" (a sizable part of the population), we 
have been developing self-paced instructional 
software for Zgrass. The prototype system now 

functions, quite well In GRAS^> (see paper by Towle 
and DeFantl, these proceedings). Both GRASS and 
Zgrass have enough supervisory functions and error 
trapping features to ' allow '■•' a good 

programmer/educator to write programs which exe¬ 
cute and verify Instructional programs written by 
beginning students. We feel that the chief prob¬ 
lem in teaching programming Is that It, as an ac¬ 
tivity k is poorly simulated by the examples and 
the Backus-Naur-type syntax Information usually 
found in manuals. Normal programmers have fellow 
workers, consultants or at least other students 
around to help, out. The home user has no such 
recourse..-, . .> MS ' « «?-• *■-•?*.- • - 

, , . The essence of the teaching problem stems 
from the fact that novices have tremendous prob¬ 
lems with meaningless (to them) error messages.. 
You really have to know nearly everything about a 
system before you can start knowing why what you 
have typed does not work. This is absolutely not 
an overstatement of the problem. -^<5 

All this commentary leads directly to comput¬ 
er aided instruction. While CAI has not quite 
lived up to its expectations for teaching other 
subjects, it can be used to teach people how to 
program. It is relatively straightforward to lead 
the user through commands, interactively teach 
looping concepts and verify the results of care¬ 
fully chosen problem sets. All possible' errors 
can be trapped and explained in detail. . Our ex¬ 
perience with this type of teaching is very 
supportive—non-programmers (primarily art stu¬ 
dents and a few university officials) can be doing 
fascinating graphics, of great beauty in half an 
hour. The whole process has the feeling of a game 
and is consistently rewarding. Providing internal- 
system support for these teaching programs is.no 
doubt the second most important design concept of 
Zgrass, after "right away" of course. 

Note that few (if any) programming languages 
allow you to write programs to interactively teach 
programming. Smalltalk[4] and Logo[5] teach by 
user experimentation in surroundings not lacking 
professional help. Flato(6) has no student pro¬ 
gram or storage space (only authors can write ai.d 
store TUTOR programs). One could probably design 


some CAI programs in Snobol or Lisp but these are 
hardly languages for rovioes and they are not 
known for their luoid error message handling, or 
availability on aioros. Perhaps a graphloe- 
extended APL night do. It would be wonderful If 
the experience with Zgrass encouraged others to 
design extensions to .languages with teaching In 

Zgrass Technical Details 3 

Zgrass is an Interpreter of commands and w as- ' 
signment statements stored internally -S as ASCII! 
strings. These strings may be entered and execut¬ 
ed line by line, formed into programs (called 
"macros"), edited, and even built and pulled apart 
by string manipulation primitives. (A compiler 
which eliminates-most of the interpretive overhead 
and which takes better advantage of the resident 
hardware floating point unit is part of the 16k 
extension ROM.) 

-i : . We are determined to maintain compatibility 
• with at least TINY BASIC (it is hard to say what 
•standard" BASIC really is). Since BASIC has line 
numbers, Zgrass labels must start with a number 
(e.g. 100, lobekenobe, 707crash, etc.). A BASIC 
program copied out of "BYTE" would simply have a 
lot of extraneous labels. Labels in Zgrass are 
obviously■ not used to order and edit the state¬ 
ments as in BASIC since one would hardly like to 
have alphabetically ordered labels and Zgrass has 
a good on-screen editor anyway. Our definition of 
compatibility is restricted to executing perfect 
programs written in BASIC.' Getting them in, edit¬ 
ing, executing and debugging them is done dif¬ 
ferently. 

Commands are made up of a keyword followed by 
zero or more operands. Examples of commands are: 

. . goto 4JaU *' '• 

*■)•< ~\ f move deathweapon,x1,y1 : ' •• - , 

-clear-- 7 ' '* ’ .S’'..'*.?■» 

, input dea,fbi,o 

print beep,"who loves ya, baby?" 

(some of the more idiosyncratic BASIC commands, 
notably - "if", and "for" have their peculiar syntax 
retained for compatibility). v 

.... Commands are gentle to users. If not enough’ 
arguments are supplied, if an Incorrect argument 
is given or the argument is non-existent, a spe¬ 
cial error fixup routine is entered. This routine 
prints out the command in error, points at the ar¬ 
gument in error and says, for example, "NO! this 
command wants a variable name here." The user can 
then type in" a correct argument and the oommand 
goes on. He can also elect to enter command mode 
to create a missing name, for example, and then 
resume the above process. All this will happen 
whether commands are entered line-by-line or exe¬ 
cuted as part of a macro. 

. Note that all commands are more or less self 
documenting. You can type the command name and it 
• asks you for the operands. This error facility 
allows one to get by trivial syntax errors without 
constant re-editing. It is also a sloppy way to 
get input to macros, although there are several 
conceptually clearer (to computer folk) ways. 

Many cocnands have options Indicated by post- 
fixing the command name with a hyphen plus a 
modifier (e.g. "input-string" which can be shor¬ 
tened to "ln-str" or even "i-s"). The hyphenated 
option construction is more English-like than 

single-character switches and it helps keep down 
proliferation of command names. 


-c 

rf? 


Since every command has an internally stored list of what argument 
...there are about 20 different argument types in 


Any string can be executed in Zgrass.If it contains meaningful 
commands, it can be used as a program. Again GRASS and Zgrass are called 
macros. Macros can call other macros, call them 


Zgrass, like numberTftTin£ ;^e* pfi Ssion;' picture 
-W J prototype, array and ao on). Further syntax and 
,r ’ ! semantic information la available in the manual 

1 but the information you need most often is at your 
fingertips "right away." 

A few more details about variables are neces- 
I sary. Variable names (macros are actually string 
variables) can be any length and must start with 
an alphabetic character. Variables used as macros 
may not have names which conflict with system 
names. Global variables start with lower case 
letters and local variables start with upper case 
letters. The system decides whether a variable is 
a numeric or string variable by examining the con- 
i text in which it is first used. 

I (Commands are terminated by semicolons "or” 

I carriage returns. The alphanumeric generator 
which is video mixed over the color graphics or 
routed to a separate monitor puts up sixteen 
32-character lines. The alphanumeric handler au¬ 
tomatically folds lines over 32 characters long 
for display purposes but does not Insert a car¬ 
riage return. A special character indicates folded 
lines.) 


Arithmetic statements are similar in format 
to assignment statements in BASIC or FORTRAN, with 
the exception of the left arrow used. The parser 
automatically changes equals signs (which are used 
for conditionals) to left arrows to maintain com¬ 
patibility with BASIC yet allow a sophisticated 
expression evaluator to operate unambiguously by 
net having to deal with'multi-purpose operators. 
Examples of arithmetic assignment statements are: 
abc*sin(arg1)+cos(arg2) 
b‘abarum«-1.2 
c«whodunit(f ,g,huhj 

where the last example contains a user-defined 
function (a macro, of course). 

Numeric variables are kept In fixed or float¬ 
ing point by the system, switching mode as neces¬ 
sary without user knowledge. The luxury of a 
floating point arithmetic unit helps calculation 
speed considerably. There are also reserved sys¬ 
tem variables which hold the values of the hand 
controls, keypad keys, external I/O strings and 
other special things. 

Strings are assigned as follows: 
tomVthis is a single line" 
sam^tom&tomibabarum ;.concatenat 

cry 

;.to enter a carriage return 
mymacroyprint tom,cr,tom," again" 

stuffyhello> . ;. stuff gets "hello 1 
for as 1 to 10 
print stuff,a 
next a> 

The last example shows nested assignments and a 
way to create a macro. Note that acceptable 
string delimiters are and ), the last 

four of which must be balanced. String decomposi¬ 
tion is handled by a variety of string commands in 
■ he 16k extension. 


selves, execute in foreground or in parallel with 
other macros in the background, supervise other 
macros and interact with macros running on other 
Zgrass machines. 

Zgrass differs from BASIC greatly when it 
comes to subroutine linkage. Zgrass has a very 
convenient and conceptually clear way of passing 
arguments—you simply make believe the macro is a 
command and use standard command syntax. Further¬ 
more, the "input" command (for numbers) and the 
"input-name" and "input-string* commands (for 
strings) fetch the arguments passed in a way that 
automatically request user input from the terminal 
• if not enough arguments are passed. This linkage 
is dlscdssed in more detail below. 

Looping and control transfer is done with 
"goto," "for/next" and "gosub." (Gosub is re¬ 
tained for compatibility.) A version of goto 
called "skip" has the option of jumping relative a 
number of lines, a good feature for those quick * 
loops in which you forgot to put the label. There 
is also a "return" command which can pass an argu¬ 
ment back if it is a function call like "whodun¬ 
nit" above. 

When a macro is asked to execute (by typing 
its name as the rirst thing on a line, like a com¬ 
mand), the system builds a macro invocation block 
(MIB). The MIB holds information about local 
variables, .for/next blocks, argument and data 
lists and so on. When the macro is done, the MIB 
is deleted along with all the pieces hanging off 
it. The storage allocation/reclamatlon algorithms 
used are again similar to GRASS'S. • 

Numeric arguments are passed using the "in¬ 
put" command. It is similar to "input" in BASIC 
but it first checks the argument list. ‘ If there 
is an argument, it is grabbed. Otherwise, the user 
is requested to enter the value. Input works in 
concert with "print" which supresses output when 
arguments are present, (or course, there are op-' 
tlons to input and print which force terminal 
I/O.) Thus, a macro that has lots of prompting in¬ 
formation can be called by another macro without 
all sorts of editing to remove the prompts, but 
the macro will wake up and start asking ouestions 
if not enough arguments are supplied. One can 
create self-documenting macros which are effi¬ 
cient, yet help out when necessary. (How many 
times have you forgotten the arguments to a 
subroutine?) 

The "input-name" command functions similarly 
for strings and is used to get names passed as ar¬ 
guments. You use the "£" operator to Indirectly 
- reference strings. For example: 
getandmove-ydagain print "gimme a pixname" 
inp-name gettemp ;.get name 

if gettempr" .return ;.if null, return 

get-tape Cgettemp ;.get it from tape 

move @gettemp,x3,y3 ;.attach control 3 

display ggettemp ;.and show it. 

..j - goto 1again> 


3S 


getandmove apple.witch.titles,, 









where the last line is the call and the lines 
-above are the nacro definition presumably entered 
'before the oall. Comments are lines or sub-lines 
which start with a *." '■ - 

The "input-string* command expects string 
delimiters around arguments passed so that whole 
commands can be arguments (you cannot pass a comma 
with the input-name option). This is important for 
the construction of teaching and verification pro¬ 
grams, among other things. If the argument is not 
there, input-string will require input from the 
keyboard, but without the string delimiters, just 
like input-name. 

The principle here is to make macros look 
like system-defined commands as much as possible, 
a rather loose definition of extensibility, but 
one that is meaningful when speaking about inter¬ 
preters (a conclusion adapted from comments in 

m>. 

Picture and Pattern Drawing 

Zgrass has several predefined variables which 
cause drawing on the screen when they are written 
into. To display a point, you set variables xs 
and ys to the x and y coordinate. When you set 
variable cs to a value from one to four, the point 
is displayed with the color value indicated by the 
value of cs. There are also the "line," "box," and 
"circle" commands which draw vectors, and filled 
rectangles and ellipses on the screen. 

Picture Animation 

Once a picture is drawn on the screen, all or 
part of it may be stored as a picture prototype 
with the "snap" command. Picture prototypes are - 
pixel lists in this case and are kept in user 16k 
RAM rather than in the screen Hk RAM. So, a pie- “ 
ture is something you see on the screen and a pic¬ 
ture prototype (or "prototype" for short) is its''* 
representation in user memory! ’ :* ** ' 

One then attaches the prototype to a vari-’ 
able, time-based variable (a user-defined special 
variable whose value varies automatically over a 
given time period), hand control, or user-defined 
function. The prototype is displayed with the 
"display" command. After that, anytime the vari¬ 
able or function changes, the prototype will be ■ 
erased with an "exclusive or" write and rewritten 
with its updated translation or other transforma¬ 
tion with an "exclusive or" write. This technique 
lets pictures of one color pass over pictures of •- 
another color without leaving holes (using stan-' 
dard bit plane raster scan graphics techniques). 
There is an interrupt level routine which manages 
movements of prototypes and a host of other de¬ 
tails, along the lines of a conventional refresh * 
graphics driver. The user has a simple way to in¬ 
dicate what maximum percentage of time should be 
allocated to interrupt level updating, the rest 
being left for command processing. 

The same interrupt'routine also manages pic¬ 
ture prototype lists made up of lists of points, 
vector endpoints, box and circle drawing informa¬ 
tion. With the 16k extension, rotation and scal¬ 
ing of these lists is possible. Prototype lists, 
of course, have to be built up rather than snapped 
using options to the line, box and circle com¬ 
mands. The user can access Individual endpoints 
and manipulate the prototype as a whole. Of * 


course, there can be many prototypes floating 
around at once. 

Again, the user's aesthetics and perceptions 
are essential. Since everything is real-time (or 
close to it) the user can easily see the effect of 
various commands on the screen,- the implications 
of varying amounts of Interrupt processing time, 
the ways of using different colors, and so on.' 

Prototype lists and patterns can be grouped 
into a tree structure which allows concatenation 
of transformations. Moreover, the "select" com¬ 
mand specifies a sequence of pictures to be put up 
-and erased in round-robin fashion.(imagine several 
views of a walking "man" being switched to provide 
the illusion of walking). A simple Super 8 camera 
hookup allows more complex, synchronized sequences 
to be filmed, if desired. 

Conclusions 

Zgrass is designed to be a first programming 
language which encourages both novices and experts 
to learn about color graphics, generate meaningful- 
and pretty displays, possibly make Super 8 movies, 
and perhaps even access governmental databases and 
control electric train sets. The software is 
designed to be multi-leveled and rich with feed¬ 
back. Considerable research into the teaching as¬ 
pects has been folded into the design. 

Continuing developmental el fort along these 
lines now concerns higher resolution displays, 
much faster microprocessors, parallel programming- 
techniques and connection to videodisks and other 
television equipment. Zgrass is one way you can 
control the amount of sex and violence on your tv 
set. 

v,. it: t .-- - • . ... 
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Addendum: Zgrass Command List (in addition to 
BASIC) 

(The commands beginning with a •*' are in the 16k 
extension.) (Not all options are indicated.) 



